Functions


Creating a Keychain

KCCreateKeychain Creates a new keychain.

Creating and Disposing of Keychain Item References

KCNewItem Creates a reference to a keychain item.
KCReleaseItem Disposes of the memory occupied by a keychain item reference.

Creating and Disposing of Keychain References

KCMakeAliasFromKCRef Creates an alias from a keychain reference.
KCMakeKCRefFromAlias Creates a keychain reference from a keychain alias.
KCMakeKCRefFromFSSpec Creates a keychain reference from a file specification record.
KCReleaseKeychain Disposes of the memory associated with a keychain reference.

Creating and Disposing of Universal Procedure Pointers (UPPs)

DisposeKCCallbackUPP Disposes of a UPP to your Keychain event-handling callback function.
NewKCCallbackUPP Creates a UPP to your Keychain event-handling callback function.

Determining Availability and Version Information

KCGetKeychainManagerVersion Determines the version of the Keychain Manager installed on the user’s system.
KeychainManagerAvailable Determines whether the Keychain Manager is available.

Locking and Unlocking Keychains

KCLock Locks a keychain.
KCUnlock Unlocks a keychain.

Managing User Interaction

KCIsInteractionAllowed Reports whether user interaction is allowed.
KCSetInteractionAllowed Enables you to specify whether user interaction is allowed.

Manipulating Keychain Items

KCAddItem Adds a keychain item to the default keychain.
KCCopyItem Copies a keychain item from one keychain to another.
KCDeleteItem Deletes a keychain item from the default keychain.
KCGetKeychain Determines the location of a keychain item.
KCUpdateItem Updates a keychain item.

Registering, Invoking, and Unregistering Your Callback Function

InvokeKCCallbackUPP Invokes your Keychain event-handling callback function.
KCAddCallback Registers your Keychain event-handling callback function.
KCRemoveCallback Unregisters your Keychain event-handling callback function.

Searching for Keychain Items

KCFindFirstItem Finds the first keychain item in a specified keychain that matches specified attributes.
KCFindNextItem Finds the next keychain item matching the previously specified search criteria.
KCReleaseSearch Disposes of the memory occupied by a search criteria reference.

Searching for Keychains

KCCountKeychains Determines the number of available keychains.
KCGetIndKeychain Obtains an indexed keychain reference.

Setting and Obtaining Keychain Information

KCChangeSettings Displays a dialog for changing the keychain name, password, and settings associated with a specified keychain.
KCGetKeychainName Obtains the name of a keychain.
KCGetStatus Obtains the status of a keychain.

Setting and Obtaining Keychain Item Attribute Data

KCGetAttribute Retrieves attribute data from a keychain item.
KCGetData Retrieves the data stored in a keychain item.
KCSetAttribute Sets or modifies attribute data for a keychain item.
KCSetData Sets or modifies the data stored in a keychain item.

Setting and Obtaining the Default Keychain

KCGetDefaultKeychain Retrieves the default keychain.
KCSetDefaultKeychain Sets the default keychain.

Storing and Retrieving Passwords

KCAddAppleSharePassword Adds a new AppleShare server password to the default keychain.
KCAddGenericPassword Adds a new generic password to the default keychain.
KCAddInternetPassword Adds a new Internet server password to the default keychain.
KCAddInternetPasswordWithPath Adds a new Internet server password with a specified path to the default keychain.
KCFindAppleSharePassword Finds the first AppleShare password in the default keychain that matches the specified parameters.
KCFindGenericPassword Finds the first generic password in the default keychain matching specified parameters.
KCFindInternetPassword Finds the first Internet password in the default keychain that matches the specified parameters.
KCFindInternetPasswordWithPath Finds the first Internet password in the default keychain that matches the specified parameters, including path information.

Working With Certificates

KCChooseCertificate Displays a list of certificates that the user can choose.
KCFindX509Certificates Finds certificates in a specified keychain that match the specified search criteria.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)